home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / os20 / util / arcalcv1_12.lzh / Docs / Italiano / ARcalc.doc next >
Text File  |  1993-03-12  |  29KB  |  708 lines

  1.  
  2.  
  3. *
  4.  
  5.  
  6. Introduzione
  7. *************
  8.  
  9.    `ARcalc' è un programma che simula una calcolatrice scientifica,
  10. sviluppato per i computer della serie Amiga. `ARcalc' può essere
  11. utilizzata con qualunque modello di Amiga che disponga di una versione
  12. di sistema operativo superiore alla 1.3.
  13.  
  14.    La versione 2.1 del Workbench introduce la localizzazione, cioè la
  15. possibilità di scrivere programmi che comunichino con l'utente nella
  16. lingua che questi ha scelto: `ARcalc' è in grado di sfruttare questa
  17. caratteristica, ed è distribuito con i files necessari alla
  18. localizzazione in numerose lingue. Sono localizzate le voci di menu,e i
  19. messaggi di errore della calcolatrice, mentre si è deciso di non
  20. localizzare le etichette dei tasti , in quanto generalmente anche sulle
  21. calcolatrici reali queste restano invariate di paese in paese.
  22.  
  23.    Le funzionalità messe a disposizione da `ARcalc' sono quelle di
  24. calcolo in virgola mobile tipiche di una calcolatrice scientifica,
  25. inclusa la capacità di eseguire calcoli interi in base binaria, ottale
  26. ed esadecimale. Le operazioni trigonometriche implementate possono
  27. essere eseguite su valori misurati in gradi, radianti o gradi decimali,
  28. e i numeri possono essere rappresentati in notazione esponenziale, con
  29. punto decimale fisso (indicando il n. di cifre decimali desiderate), o
  30. in un modo misto. Indipendentemente dal formato di rappresentazione
  31. usato, tutti i calcoli sono svolti in doppia precisione.
  32.  
  33.    `ARcalc' è attualmente alla versione 1.1. La versione 1.0, peraltro
  34. mai rilasciata, era priva di localizzazione.
  35.  
  36.    Ricordate che `ARcalc' *non* funziona nelle versioni di sistema
  37. operativo inferiore alla 2.0; se cercate di farla partire in tale caso,
  38. semplicemente non accade nulla.
  39.  
  40.  
  41. Uso di ARcalc
  42. **************
  43.  
  44.    Il programma può essere lanciato tanto da Workbench quanto da
  45. Shell,e si presenta visivamente come una calcolatrice posta sullo
  46. schermo del Workbench, in cui si possono facilmente distinguere il
  47. display e la tastiera. D'ora in poi, per evitare confusione, chiameremo
  48. `tasti' quelli della tastiera dell'Amiga, mentre per riferirci a quelli
  49. della calcolatrice parleremo di `bottoni'.
  50.  
  51.    `ARcalc' è stata progettata in modo da essere font-sensitive: essa
  52. cioè può essere visualizzata con qualunque font e dimensione l'utente
  53. decida, adattandosi ad esso. Al lancio, il font con cui visualizzare la
  54. calcolatrice, così come altre caratteristiche che vedremo più avanti,
  55. viene determinato grazie ad un file di configurazione presente nella
  56. stessa directory di `ARcalc', di nome `ARcalc.config'; se tale file è
  57. assente, è utilizzato per default lo stesso font usato dal Workbench.
  58. E` altresì possibile specificare un font sulla linea di comando (in
  59. caso di lancio da Shell) con la seguente sintassi:
  60.  
  61.    `ARcalc <nome font> <dimensione Y>'
  62.  
  63.    In questo caso `ARcalc' cercherà di usare questo font, anche se
  64. fosse presente il file di configurazione. Il font scelto (che può
  65. essere di bitmap o compugraphic, proporzionale o meno) viene utilizzato
  66. per le label associate ai tasti e per il display, ma non per i menu;
  67. esso può essere modificato anche dopo il lancio, tramite la scelta
  68. `Cambia font...' nel sottomenu `Parametri' del menu `Progetto' (See I
  69. menu di ARcalc. ).
  70.  
  71.    Il lancio di `ARcalc' può fallire per diversi motivi (mancanza di
  72. memoria, scelta di un font troppo grande, errori in apertura di
  73. librerie...); in tal caso l'utente viene avvertito tramite un
  74. appropriato messaggio di errore.
  75.  
  76.    Una delle peculiarità di `ARcalc' è che permette di introdurre
  77. espressioni complesse esattamente come vengono scritte normalmente.
  78. Tale operazione può essere fatta sia digitando manualmente
  79. l'espressione usando la tastiera del computer, che agendo mediante il
  80. mouse sui bottoni della calcolatrice. Nella parte superiore del
  81. display, che chiameremo in seguito "area di editing", è visibile
  82. l'espressione che si sta introducendo, ed essa può essere editata
  83. facendo uso dei tipici shortcut degli string gadget Amiga, o mediante
  84. gli appositi bottoni di editing.
  85.  
  86.    Per calcolare il valore dell'espressione impostata, è sufficiente
  87. premere il tasto `RETURN' di Amiga, o il bottone `=' della
  88. calcolatrice; il risultato comparirà nella parte inferiore destra del
  89. display, che chiameremo "area risultati". Nell'area risultati, oltre ai
  90. valori della computazione, possono essere anche visualizzati eventuali
  91. errori di sintassi o di calcolo. Se si verifica un errore di sintassi,
  92. il cursore dell'area di editing si posiziona sul punto dell'espressione
  93. dove si è riscontrato l'errore, permettendo così di correggerlo; la
  94. posizione del cursore non è invece significativa in caso di errore di
  95. calcolo. Per un elenco completo degli errori di sintassi e di calcolo
  96. si rimanda alla sezione 5 di questo manuale (See I menu di ARcalc. ).
  97.  
  98.  
  99. Descrizione dettagliata dei bottoni di ARcalc
  100. **********************************************
  101.  
  102.    Si darà ora una descrizione dettagliata della funzione svolta dai
  103. bottoni della calcolatrice. I bottoni si dividono nelle seguenti classi:
  104.  
  105.  
  106. Bottoni di editing
  107. ===================
  108.  
  109.    I Bottoni di editing si trovano nella parte superiore destra della
  110. calcolatrice, e servono ad eseguire le più comuni operazioni di
  111. editing. I bottoni di editing sono i seguenti:
  112.  
  113. `<='
  114.      (freccia sinistra): questo bottone permette di spostare a sinistra
  115.      di un carattere il cursore dell'area di editing. Analoga funzione
  116.      può essere ottenuta mediante la freccia sinistra della tastiera
  117.      di Amiga.
  118.  
  119. `=>'
  120.      (freccia destra): questo bottone permette di spostare a destra di
  121.      un carattere il cursore dell'area di editing. Analoga funzione
  122.      può essere ottenuta mediante la freccia destra della tastiera di
  123.      Amiga.
  124.  
  125. `Del'
  126.      (Delete): questo bottone permette di cancellare il carattere su
  127.      cui si trova il cursore dell'area di editing. Analoga funzione
  128.      può essere ottenuta mediante il tasto Del di Amiga.
  129.  
  130. `Bck'
  131.      (Backspace): questo bottone permette di cancellare il carattere
  132.      alla immediata sinistra del cursore nell'area di editing. Analoga
  133.      funzione può essere ottenuta mediante il tasto <- di Amiga.
  134.  
  135. `Clr'
  136.      (Clear): questo bottone permette di cancellare tutta
  137.      l'espressione. Analoga funzione può essere ottenuta mediante la
  138.      pressione dei tasti Amiga-Left X
  139.  
  140.  
  141. Bottoni di stato
  142. =================
  143.  
  144.    I Bottoni di stato sono caratterizzati dal fatto di modificare lo
  145. stato della calcolatrice. Lo stato complessivo della calcolatrice è
  146. visibile nella parte inferiore sinistra del display, rappresentato da
  147. alcune sigle: per comodità chiameremo "area di stato" l'area del
  148. display in cui tali sigle compaiono. Si noti che lo stato complessivo
  149. al lancio del programma dipende dal contenuto del file di
  150. configurazione `ARcalc.config'; se questo non è presente, vengono
  151. assunti dei valori di default, indicati nel seguito.
  152.  
  153.    I bottoni di stato sono i seguenti:
  154.  
  155. `Bse'
  156.      (numeric BaSE): questo bottone permette di scegliere la base in
  157.      cui si desidera lavorare. La base attuale è visibile nell'area di
  158.      stato, mediante uno dei seguenti simboli:
  159.  
  160.     `dec'
  161.           base decimale
  162.  
  163.     `hex'
  164.           base esadecimale
  165.  
  166.     `oct'
  167.           base ottale
  168.  
  169.     `bin'
  170.           base binaria
  171.  
  172.      La pressione del bottone `Bse' produce il passaggio da una base
  173.      alla successiva nel seguente ordine:
  174.  
  175.      `... -> dec -> hex -> bin -> oct -> ...'
  176.  
  177.      Il cambio di base da luogo automaticamente all'annullamento
  178.      dell'espressione eventualmente presente nell'area di editing,
  179.      perchè ogni numero nella espressione cambierebbe valore nella
  180.      nuova base. Si noti che quandola base non è quella esadecimale
  181.      alcuni dei bottoni della calcolatrice, pur continuando a
  182.      funzionare, perdono di significato (p.e. i tasti `A', `B', `C',
  183.      `D', `E', `F' in base decimale non sono utili, anche se continano a
  184.      funzionare). `ARcalc' inoltre non è in grado di utilizzare numeri
  185.      non interi in basi diverse da quella decimale: ciò comporta anche
  186.      il fatto che alcune funzioni non siano più significative pur
  187.      continuando ad essere utilizzabili (p.e. la funzione `sin(X)', pur
  188.      funzionando perfettamente in ogni base, può restituire solo i
  189.      valori 0 o 1 se la base non è decimale). Se non è presente il
  190.      file `ARcalc.config', al lancio del programma viene usata la base
  191.      decimale.
  192.  
  193. `Fse'
  194.      (Fixed,Scientific,normal): questo bottone permette di scegliere la
  195.      notazione di visualizzazione dei risultati tra le seguenti tre
  196.      modalità:
  197.  
  198.      `Fissa': indicato dal sibolo `fix' nell'area di stato, tale
  199.      formato prevede la visualizzazione del risultato con un numero
  200.      fissato di cifre decimali. Il numero di cifre decimali è
  201.      definibile mediante il tasto `Fix'.
  202.  
  203.      `Scientifica': indicato dal simbolo `sci' nell'area di stato, tale
  204.      formato prevede la visualizzazione del risultato in notazione
  205.      scientifica. Si noti che in tale formato il numero di cifre
  206.      significative fissato con il bottone `Fix' non è più riferito
  207.      alle cifre decimali, ma alle cifre componenti la base del numero
  208.      in notazione scientifica.
  209.  
  210.      `Normale': indicato dal simbolo `nor' nell'area di stato, tale
  211.      formato è un misto dei due precedenti: il risultato verrà
  212.      visualizzato nel formato che produrrà la stringa più piccola,
  213.      tra quello scientifico e quello a virgola fissa.
  214.  
  215.      Si noti che nel passaggio da un formato all'altro il risultato
  216.      dell'ultima espressione viene rivisualizzato nel nuovo formato. Se
  217.      non è presente il file `ARcalc.config', al lancio del programma
  218.      viene usata la notazione normale.
  219.  
  220. `Drg'
  221.      (Degrees,Radiant,decimal degrees (Grad) ): Questo bottone permette
  222.      di scegliere l'unità di misura degli archi per le funzioni
  223.      trigonometriche. Le possibili unità di misura sono:
  224.  
  225.         * `Gradi': caratterizzati dal simbolo `deg' nell'area di stato
  226.  
  227.         * `Radianti': caratterizzati dal simbolo `rad' nell'area di
  228.           stato
  229.  
  230.         * `Gradi decimali': caratterizzati dal simbolo `Grad' nell'area
  231.           di stato
  232.  
  233.      Se non è presente il file `ARcalc.config', al lancio del
  234.      programma gli archi si considerano misurati in radianti.
  235.  
  236. `Fix'
  237.      (Fix significant digits): questo bottone permette di fissare, a
  238.      seconda della notazione attualmente in uso, il numero di cifre
  239.      dopo la virgola (notazione fissa) o il numero di cifre
  240.      significative (notazione scientifica o normale). Quando questo
  241.      bottone viene premuto, nella parte inferiore del display compare
  242.      la seguente scritta:
  243.  
  244.      `Numero di cifre (0-9)'
  245.  
  246.      a questo punto l'utente dovrebbe premere uno dei bottoni numerici
  247.      della calcolatrice tra 0 e 9, indicando così il numero di cifre
  248.      desiderato: qualunque altro bottone venga premuto comporta
  249.      l'annullamento della operazione, mantenendo invariato il numero di
  250.      cifre. Si ricorda che qualunque sia il numero di cifre fissato,
  251.      tutti i calcoli vengono svolti in doppia precisione. Se non è
  252.      presente il file `ARcalc.config', al lancio del programma viene
  253.      usato il numero massimo di cifre, cioè nove.
  254.  
  255. `Inv'
  256.      (Inverse function): questo bottone premette di ottenere le
  257.      funzioni inverse delle funzioni presenti nella tastiera della
  258.      calcolatrice. Quando viene premuto, nell'area di stato compare il
  259.      simbolo `Inv': se il prossimo tasto premuto sarà un tasto
  260.      indicante una funzione, allora nell'espressione verrà introdotta
  261.      la funzione inversa corrispondente, a patto che questa sia
  262.      definita (p.e. non è definita la f.ne inversa della funzione
  263.      fattoriale *Fact*). La pressione del bottone Inv non produce
  264.      nessun risultato se il bottone successivo non è associato ad una
  265.      funzione, o se tale funzione non ammette funzione inversa.
  266.  
  267. `Hyp'
  268.      (Hyperbolic function): questo bottone permette di ottenere le
  269.      funzioni iperboliche. Quando viene premuto, nell'area di stato
  270.      compare il simbolo `Hyp': se il successivo bottone premuto sarà
  271.      relativo ad una funzione trigonometrica, verrà inserita
  272.      nell'espressione la corrispondente funzione iperbolica. Il tasto
  273.      Inv può essere usato insieme a questo tasto per ottenere le
  274.      funzioni inverse delle funzioni iperboliche. La pressione del
  275.      bottone `Hyp' non produce alcun effetto se il successivo premuto
  276.      non è associato ad una funzione trigonometrica.
  277.  
  278.  
  279. Bottoni di testo
  280. =================
  281.  
  282.    I bottoni di testo permettono di inserire nella espressione in
  283. editing cifre, funzioni, operatori etc. Tutto ciò che viene inserito
  284. mediante i bottoni di testo può essere digitato anche tramite la
  285. tastiera di Amiga, ma tali bottoni offrono una comoda scorciatoia. Si
  286. noti che il parser delle espressioni non è case sensitive, e quindi
  287. queste si possono digitare senza preoccuparsi di usare caratteri
  288. maiuscoli o minuscoli. Diamo di seguito l'elenco dei bottoni di testo
  289. presenti nella calcolatrice:
  290.  
  291. `log'
  292.      da solo produce la stringa `Log(', indicante la funzione
  293.      *logaritmo* in base 10; in congiunzione con `Inv' produce la
  294.      stringa `10^', dove `^' è il simbolo di elevamento a potenza.
  295.  
  296. `ln'
  297.      da solo produce la stringa `Ln(', indicante la funzione
  298.      *logaritmo* in base e (numero di nepero); in congiunzione con
  299.      `Inv' produce la stringa `e^'.
  300.  
  301. `x2'
  302.      da solo produce la stringa `^2', indicante l'elevamento alla
  303.      seconda potenza; in congiunzione con `Inv' produce la stringa
  304.      `Sqrt(',indicante la funzione *radice quadrata*.
  305.  
  306. `mod'
  307.      produce la stringa `Mod(', indicante la funzione *modulo*, cioè
  308.      il resto nella divisione del primo argomento per il secondo
  309.      (`Mod(11,3) restituisce 2')
  310.  
  311. `sin'
  312.      da solo produce la stringa `Sin(', indicante la funzione
  313.      trigonometrica *seno*. In congiunzone con `Inv' produce la stringa
  314.      `ArcSin(', indicante la funzione *arcoseno*. ATTENZIONE: il
  315.      risultato dell'applicazione di tali funzione dipende dall'unità
  316.      di misura scelta per l'arco (RAD, DEG, GRAD). In congiunzione con
  317.      `Hyp' produce la stringa `Sh(', indicante la funzione *seno
  318.      iperbolico*. Se anche `Inv' era stato premuto viene prodotta la
  319.      stringa `ArcSh(', indicante la funzione *settore seno iperbolico*
  320.  
  321. `cos'
  322.      da solo produce la stringa `Cos(', indicante la funzione
  323.      trigonometrica *coseno*. In congiunzone con `Inv' produce la
  324.      stringa `ArcCos(', indicante la funzione *arcocoseno*. ATTENZIONE:
  325.      il risultato dell'applicazione di tali funzione dipende
  326.      dall'unità di misura scelta per l'arco (RAD, DEG, GRAD). In
  327.      congiunzione con `Hyp' produce la stringa `Ch(', indicante la
  328.      funzione *coseno iperbolico*. Se anche `Inv' era stato premuto
  329.      viene prodotta la stringa `ArcCh(', indicante la funzione *settore
  330.      coseno iperbolico*
  331.  
  332. `tan'
  333.      da solo produce la stringa `Tan(', indicante la funzione
  334.      trigonometrica *tangente*. In congiunzone con `Inv' produce la
  335.      stringa `ArcTan(', indicante la funzione *arcotangente*.
  336.      ATTENZIONE: il risultato dell'applicazione di tali funzione
  337.      dipende dall'unità di misura scelta per l'arco (RAD, DEG, GRAD).
  338.      In congiunzione con `Hyp' produce la stringa `Th(', indicante la
  339.      funzione *tangente iperbolica*. Se anche `Inv' era stato premuto
  340.      viene prodotta la stringa `ArcTh(', indicante la funzione *ettore
  341.      tangente iperbolica*
  342.  
  343. `and'
  344.      produce la stringa `and', indicante l'operatore infisso di *and*
  345.      bit a bit. L'uso di questo operatore forza gli argomenti ad interi
  346.      a 32 bit.
  347.  
  348. `or'
  349.      produce la stringa `or', indicante l'operatore infisso di *or* bit
  350.      a bit. L'uso di questo operatore forza gli argomenti ad interi a
  351.      32 bit.
  352.  
  353. `not'
  354.      produce la stringa `not', indicante l'operatore prefisso di *not*
  355.      bit a bit. L'uso di questo operatore forza l'argomento ad intero a
  356.      32 bit.
  357.  
  358. `xor'
  359.      produce la stringa `xor', indicante l'operatore infisso di *xor*
  360.      bit a bit. L'uso di questo operatore forza gli argomenti ad interi
  361.      a 32 bit.
  362.  
  363. `fct'
  364.      produce la stringa `Fact(', indicante la funzione *fattoriale*.
  365.  
  366. `rnd'
  367.      produce la stringa `Rnd(', indicante una funzione *ad un
  368.      argomento* per la generazione di un numero pseudocasuale. Se x e`
  369.      il valore dell'argomento, il numero pseudo casuale viene generato
  370.      nell'intervallo `[0,X]' se X`>0', nell'intervallo `[X,0]'
  371.      altrimenti.
  372.  
  373. `( e )'
  374.      (bottoni parentesi aperta e chiusa): producono i corrispondenti
  375.      caratteri.
  376.  
  377. `Pi'
  378.      produce la stringa `Pi', che raprresenta la costante simbolica
  379.      *Pi-greco*. In fase di calcolo tale costante assume il valore
  380.      corrispondente in doppia precisione
  381.  
  382. `e'
  383.      produce la stringa `e', che rappresenta la costante simbolica
  384.      *numero e* (di Nepero). In fase di calcolo tale costante assume il
  385.      valore corrispondente in doppia precisione.
  386.  
  387. `0,1,2,3,4,5,6,7,8,9,A,B,C,D,E,F'
  388.      producono il carattere corrispondente, indicante una cifra.
  389.      L'interpretazione dei numeri presenti nell'espressione dipende
  390.      ovviamente dalla base settata; questi tasti restano comunque tutti
  391.      utilizzabili in ogni base, anche se l'uso di alcuni di essi in
  392.      basi diverse da quelle esadecimali è inutile.
  393.  
  394. `Exp'
  395.      produce il carattere `E', che si usa nella scrittura di un numero
  396.      in forma esponenziale. Si noti che nella analisi sintattica
  397.      dell'espressione non si considerano differenti i caratteri `E',
  398.      prodotto dal tasto `Exp', ed `e', prodotto dal tasto `e' (costante
  399.      di Nepero); questi possono apparire in entrambi i casi maiuscoli o
  400.      minuscoli, e il significato che viene ad essi attribuiti dipende
  401.      dal contesto.
  402.  
  403. `,'
  404.      (virgola): produce il carattere corrispondente. L'unico utilizzo
  405.      di questo tasto è nella scrittura della funzione `mod(A,B)';
  406.      poichè tale funzione ha due parametri, è necessario separarli
  407.      mediante una ",". La presenza di un apposito tasto garantisce la
  408.      completa usablità della calcolatrice via mouse.
  409.  
  410. `+,-,*,/,^'
  411.      producono il corrispondente carattere, indicante rispettivamente
  412.      l'operatore *somma*, *differenza*, *prodotto*, *rapporto*,
  413.      *elevamento a potenza*. Si noti che il `-' può essere anche
  414.      utilizzato come preoperatore per modificare il segno dell'operando.
  415.  
  416. `v,w,x,y,z'
  417.      questi bottoni rappresentano delle variabili utilizzabili nelle
  418.      espressioni. se Premuti, producono il carattere corrispondente,
  419.      indicante appunto una variabile. Per l'assegnamento di un valore a
  420.      queste variabili, vedere il bottone speciale `sto'.
  421.  
  422.  
  423. Bottoni speciali
  424. =================
  425.  
  426.    Raggruppiamo in questa classe tutti quei bottoni la cui pressione
  427. produce qualche particolare azione non direttamente legata all'editing
  428. di un'espressione. Tali bottoni sono:
  429.  
  430. `sto'
  431.      consente di memorizzare il valore dell'espressione attuale in una
  432.      variabile. Quando questo tasto viene premuto, nella parte
  433.      inferiore del display viene stampato un messaggio, che richiede di
  434.      scegliere la variable in cui memorizzare il valore:
  435.  
  436.      `Scegli la variabile:'
  437.  
  438.      a questo punto l'utente dovrebbe premere uno dei tasti-variabile
  439.      persenti alla sinistra della tastiera numerica: l'espressione
  440.      attualmente in editing verrà valutata, e il valore computato
  441.      sarà assegnato alla variabile scelta. Quando questa variabile
  442.      verrà inclusa in un'espressione, il suo valore sarà utilizzato
  443.      in fase di calcolo.
  444.  
  445. `cpy'
  446.      permette di inserire nell'espressione, alla posizione indicata dal
  447.      cursore, il valore precedentemente calcolato, presente nella area
  448.      risultati.
  449.  
  450. `get'
  451.      permette di copiare dalla clipboard Amiga un'espressione
  452.      eventualmente postavi da un altra applicazione. Eventuali
  453.      caratteri con codice ASCII minore di 32 o maggiore di 126 vengono
  454.      eliminati dalla stringa.
  455.  
  456. `put'
  457.      permette di copiare il risultato di una espressione nella clipboard
  458.      Amiga, rendendola disponibile ad un'altra applicazione.
  459.  
  460. `='
  461.      (uguale): la pressione di questo tasto produce la valutazione
  462.      dell'espressione attuale, e la visualizzazione del risultato (o di
  463.      un messaggio di errore) nella area risultati. Dopo la
  464.      computazione, l'espressione nell'area di editing può essere
  465.      automaticamente cancellata o meno, in funzione dello stato del flag
  466.      `AutoCLR', settabile dall'utente grazie al sottomenu `Parametri'
  467.      See I menu di ARcalc.
  468.  
  469.  
  470. I menu di ARcalc
  471. *****************
  472.  
  473.    `ARcalc' dispone di due menu, che nella localizzazione italiana sono
  474. indicati come `Progetto' e `Clipboard'. Il menu `Progetto' ha le
  475. seguenti voci:
  476.  
  477. `Parametri'
  478.      questo è un sottomenu, mediante il quale è possibile  modificare
  479.      o fissare alcune delle caratteristiche della calcolatrice.  Le
  480.      voci del sottomenu sono le seguenti:
  481.  
  482.     `Cambia font ...'
  483.           permette di modificare il font con cui la calcolatrice è
  484.           rappresentata, mediante l'uso di un font requester standard
  485.           Amiga. Se il font scelto risultasse troppo grande, o non
  486.           esistente, verrebbe visualizzato un appropriato messaggio di
  487.           errore, e la calcolatrice non varierebbe; in caso contrario
  488.           verrebbe rivisualizzata utilizzando il nuovo font.
  489.  
  490.     `Usa font WB'
  491.           consente di modificare il font come per la voce precedente,
  492.           ma utilizzando il font di default dello schermo del Workbench.
  493.  
  494.     `AutoCLR'
  495.           questa voce permette di attivare o disattivare la funzione di
  496.           *auto-clear* della calcolatrice. Quando l'utente preme
  497.           return, il bottone `=',il bottone `sto', o il tasto RETURN,
  498.           l'espressione viene computata e, se la funzione di
  499.           *auto-clear* è attiva, il testo dell'espressione viene
  500.           cancellato, in modo da permettere immediatamente un nuovo
  501.           inserimento. Se la funzione di *auto-clear* è invece
  502.           disattivata, il testo della espressione precedente non viene
  503.           cancellato, e può essere ritoccato. La funzione di
  504.           *auto-clear* è attivata quando la voce del menu è preceduta
  505.           dal simbolo `checkmark Amiga'.
  506.  
  507.     `Salva parametri'
  508.           Permette di salvare lo stato e i settings della calcolatrice
  509.           in un file nominato `ARcalc.config'. Quando la calcolatrice
  510.           viene lanciata, cerca questo file e, se lo trova, si apre con
  511.           le caratteristiche in esso fissate. Le caratteristiche che
  512.           vengono fissate all'atto della scelta della voce `Salva
  513.           parametri' sono le seguenti:
  514.  
  515.              * posizione della calcolatrice sullo screen;
  516.  
  517.              * font utilizzato;
  518.  
  519.              * stato del flag AutoCLR.
  520.  
  521.              * stato della calcolatrice, cioè base numerica, unità di
  522.                misura dell'arco, formato di rappresentazione, numero di
  523.                cifre significative.
  524.  
  525. `Informazioni ...'
  526.      mostra un quadro con le informazioni sul programma e sul suo
  527.      autore. Analogo risultato si ottiene con la pressione del tasto
  528.      `Inf' della calcolatrice.
  529.  
  530. `Termina'
  531.      termina l'uso della calcolatrice. Analogo risultato si ottiene
  532.      premendo il gadget di chiusura della finestra della calcolatrice.
  533.  
  534.    Il menu `Clipboard' ha le seguenti voci:
  535.  
  536. `Taglia risultato'
  537.      copia il risultato dell'ultimo calcolo eseguito nella clipboard
  538.      Amiga. Analogo risultato si ottiene con la pressione del tasto
  539.      `put' della calcolatrice.
  540.  
  541. `Incolla espressione'
  542.      copia il contenuto della clipboard Amiga nell'area di editing
  543.      dell'espressione corrente, eliminando eventuali caratteri non
  544.      leggibili (come i newline). Analogo risultato si ottiene con la
  545.      pressione del tasto `get' della calcolatrice.
  546.  
  547.  
  548. I messaggi di errore
  549. *********************
  550.  
  551.    Diamo qui un elenco dettagliato dei messaggi di errore che possono
  552. comparire nell'area risultati del display, in seguito alla pressione
  553. del bottone `=', `sto', o del tasto RETURN. Per una descrizione
  554. generale del fenomeno, See Uso di ARcalc.
  555.  
  556.  
  557. Errori di sintassi
  558. ===================
  559.  
  560.    * `Operatore non valido': dopo un operando valido, è presente una
  561.      sequenza di simboli non riconosciuta come operatore.
  562.  
  563.    * `mancano cifre nel numero': visualizzato quando dopo il punto
  564.      indicante il termine della parte intera, non sono state digitate
  565.      le cifre decimali di un numero.
  566.  
  567.    * `Esponente non valido': visualizzato quando l'esponente di un
  568.      numero espresso in forma esponenziale, supera il valore massimo
  569.      consentito ( 300 ), o manca, o comunque non è corretto.
  570.  
  571.    * `Mancano parentesi': mancano parentesi nell'espressione. Parentesi
  572.      che erano state aperte, non sono mai state chiuse.
  573.  
  574.    * `Operando sconosciuto': dove dovrebbe esserci un operando, vi è
  575.      una sequenza di simboli non interpretabile come tale.
  576.  
  577.    * `Manca un operando': l'espressione termina con un operatore, cui
  578.      non segue un operando.
  579.  
  580.    * `Troppe cifre': nel numero sono presenti troppe cifre.
  581.  
  582.  
  583. Errori di calcolo
  584. ==================
  585.  
  586.    * `Underflow': una qualche operazione ha prodotto un risultato così
  587.      piccolo da non essere rappresentabile in doppia precisione.
  588.  
  589.    * `Overflow' o `numero non valido': una qualche operazione ha
  590.      prodotto un risultato tanto grande da essere al di fuori del range
  591.      di numeri rappresentabili in doppia precisione
  592.  
  593.    * `Divisione per zero': si è prodotta una divisione per zero.
  594.  
  595.    * `Divisione per zero nel modulo': poichè non si può dividere un
  596.      numero per zero, tantomeno se ne può ottenere il modulo nella
  597.      divisione per zero.
  598.  
  599.    * `Argomento di ArcSin() fuori dal dominio': l'argomento di questa
  600.      funzione deve cadere nell'intervallo [-1,1]
  601.  
  602.    * `Argomento di ArcCos() fuori dal dominio': l'argomento di questa
  603.      funzione deve cadere nell'intervallo [-1,1]
  604.  
  605.    * `Argomento di ArcCh() fuori dal dominio': l'argomento di questa
  606.      funzione deve essere >= 1
  607.  
  608.    * `Argomento di ArcTh() fuori dal dominio': l'argomento di questa
  609.      funzione deve cadere nell'intervallo (-1,1) (gli estremi sono
  610.      esclusi).
  611.  
  612.    * `L'argomento del logaritmo deve essere positivo': Indica che è
  613.      stata applicata la funzione ln(x) o log(x) ad un valore negativo o
  614.      nullo, quando entrambe queste funzioni sono definite solo per
  615.      valori positivi dell'argomento.
  616.  
  617.    * `L'argomento di Sqrt() non può essere negativo': la funzione
  618.      Sqrt() (radice quadrata) è definita solo per valori non negativi.
  619.  
  620.    * `L'argomento di Fact() non può essere negativo': la funzione
  621.      fattoriale è definita solo per valori non negativi dell'argomento.
  622.  
  623.  
  624. Sviluppi futuri
  625. ****************
  626.  
  627.    Se questo programma sarà in qualche misura apprezzato, in futuro mi
  628. piacerebbe estenderlo. Vorrei aggiungere una porta `AREXX', che
  629. consenta ad altri programmi di utilizzare `ARcalc' per il calcolo delle
  630. loro funzioni. C'è anche l'eventualità che a questo programma vengano
  631. affiancati altri moduli integrati, come per esempio un plotter di
  632. funzioni o un programma per il calcolo di funzioni complesse mediante
  633. programmi scritti in un piccolo linguaggio ad hoc, che sfrutteranno
  634. `ARcalc' come host di calcolo.
  635.  
  636.    Qualunque altro suggerimento sarà preso in considerazione.
  637.  
  638.  
  639. Ringraziamenti
  640. ***************
  641.  
  642.    Ringrazio alcune persone, per l'aiuto che mi hanno dato:
  643.  
  644.    * Marco Caimi, Federica Colla, Paolo Silvera, Marco Zandonadi, per
  645.      il beta test del programma;
  646.  
  647.    * Steve McKinty per la revisione della documentazione in inglese (ho
  648.      modificato qualcosa dopo la sua revisione, per cui forse non è
  649.      ancora perfetto)
  650.  
  651.    * Reinhard Spisser per la documentazione TexInfo e AmigaGuide;
  652.  
  653.    * Tutti i miei *localizzatori ufficiali*, che hanno reso possibile la
  654.      distribuzione di `ARcalc' con una tale varietà di linguaggi:
  655.  
  656.         * Steve McKinty (inglese)
  657.  
  658.         * Reinhard Spisser (tedesco)
  659.  
  660.         * Frank Bignone (francese)
  661.  
  662.         * Fer de Jong (olandese)
  663.  
  664.         * Hannu Helminen (finlandese)
  665.  
  666.         * Anders Hammarquist (svedese)
  667.  
  668.         * Soeren Berg Hansen (danese)
  669.  
  670.    * Tutta la "comunità Amiga" del Dipartimento di Scienze
  671.      dell'Informazione della Universita` di Milano, per il loro
  672.      contagiante entusiasmo, che mi ha aiutato a portare a termine
  673.      questo progetto.
  674.  
  675.  
  676. Note di distribuzione
  677. **********************
  678.  
  679.    `ARcalc' è un programma shareware copyright (C) 1992,1993 di
  680. Roberto Attias. Potete ridistribuire questo programma liberamente, a
  681. patto che tutti i suoi files siano inclusi nella copia nella loro forma
  682. originale, senza subire alcuna modifica, e che vi sia un ricarico solo
  683. nominale per la sua distribuzione; se vi piace e lo ritenete utile,
  684. avete l'obbligo morale di corrispondere all'autore la cifra di $10. Se
  685. non ritenete che questo programma sia sufficientemente utile per
  686. pagarlo, per favore, mandatemi un e-mail (o una lettera) per farmi
  687. conoscere le vostre opinioni.
  688.  
  689.    Questo programma è distribuito privo di garanzie di qualunque tipo,
  690. esplicite o implicite. Nell'usare `ARcalc' voi accettate qualunque
  691. rischio riguardante la qualità o le prestazioni dello stesso.
  692.  
  693.    Qualunque suggerimento, commento o lamentela e` gradito.
  694.  
  695.  
  696. Come raggiungere l'autore
  697. **************************
  698.  
  699.      e-mail: attias@ghost.sm.dsi.unimi.it
  700.      
  701.      Posta:Roberto Attias
  702.      Via Lissoni, 5
  703.      20162 Milano (MI)
  704.      Italia
  705.      
  706.      Tel:(02)-6470375
  707.  
  708.